home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / BZIP2 / 980316 / bzip / !ReadMe < prev    next >
Text File  |  1998-03-16  |  3KB  |  59 lines
  1. What's going on here?
  2. ~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is the second release of bzip2 version 0.1 patch level 2 for RISC
  5. OS.  bzip2 is a lossless compression program in the same style as gzip.
  6. It requires a lot of memory to run but typically achieves considerably
  7. better compression ratios than gzip.  It is becoming increasingly
  8. popular in the Unix community.  bzip2 is distributed under the terms of
  9. the GNU General Public Licence, see the file `Copying' for details.
  10.  
  11. How do I use it?
  12. ~~~~~~~~~~~~~~~~
  13.  
  14. There is currently no wimp front end for bzip2.  There is also no
  15. sprite file available.  To install bzip2, if you have an Acorn-style
  16. boot sequence, you may simply run the !Install script.  If not, then
  17. copy `bzip2' to somewhere on your Run$Path, and ensure that the lines
  18. in `RunMe' are executed at boot time.
  19.  
  20. To decompress files, simply doubleclick on them.  Note that it spawns
  21. a taskwindow to do this so you can continue to do other things while
  22. it decompresses.  To compress files, you will have to invoke bzip2
  23. from the command line, until I have a front end.
  24.  
  25. There are a few differences from the Unix version, which is documented
  26. in the `Docs' file.  Instead of giving compressed files the same name
  27. plus a `.bz2' extension, they have filetype &16E.  Decompressed files
  28. all have filetype Data (&FFD) since the file format does not permit me
  29. to store the original filetype within the compressed file.  I'm
  30. currently negotiating with the author to work out a scheme that would
  31. permit this.  
  32.  
  33. Technical notes
  34. ~~~~~~~~~~~~~~~
  35.  
  36. As distributed, it runs in `small' mode which reduces the memory
  37. requirement to 2428k but makes decompression slower.  If you have a RiscPC,
  38. it will use a dynamic area to store its data, which improves speed
  39. somewhat.  If you prefer speed to memory usage, then you may wish to remove
  40. the `-s' option which will cause it to use twice as much memory.
  41.  
  42. When (de)compressing, it uses a temporary file in the same directory as the
  43. file which you are (de)compressing, then deletes the original, renames the
  44. new file and sets the file type appropriately.  This can fail if you have
  45. a read-only filesystem or the directory is full.  You may wish to use the
  46. `-c' option to bzip2 and redirect the output to a different file.  Also,
  47. the `-k' option will leave you with the original file untouched and a new
  48. file `bzXXXXXX' where the X's are replaced with digits.  This is the best
  49. solution I can think of; if anyone has any better ideas, let me know.
  50.  
  51. The original source code is available from
  52. http://www.muraroa.demon.co.uk/.  The Patch file contains a unified
  53. diff format patch from the pl2 source which is currently available on
  54. the source website.  I think this discharges my legal & moral
  55. obligations under the GPL.
  56.  
  57. May the entropy of your files be maximised.
  58. Matthew Wilcox <willy@bofh.ai>, 16th March 1998
  59.